<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>lib/stat-size.h</title>
<meta name='robots' content='noindex,nofollow' />
<meta name='generator' content='GLOBAL-6.5.7' />
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' type='text/css' href='../style.css' />
</head>
<body>
<!-- beginning of fixed guide -->
<div id='guide'><ul>
<li><a href='#TOP'><img class='icon' src='../icons/first.png' alt='[^]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/last.png' alt='[v]' /></a></li>
<li><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a></li>
<li><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a></li>
<li><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a></li>
<li class='standout'><span><a href='../files/lib.html'>lib</a>/stat-size.h</span></li>
</ul></div>
<!-- end of fixed guide -->
<a id='TOP' name='TOP'></a><h2 class='header'><a href='../mains.html'>root</a>/<a href='../files/lib.html'>lib</a>/stat-size.h</h2>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><img class='icon' src='../icons/n_top.png' alt='[top]' /><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+1 lib/stat-size.h'  /> */</em>
<hr />
<h2 class='header'><a href='src--filemanager--ioblksize.h.html#L20' title='Included from 20 in src/filemanager/ioblksize.h.'>INCLUDED FROM</a></h2>
<hr />
<pre>
<a id='L1' name='L1'></a>   1 <em class='comment'>/* macros useful in interpreting size-related values in struct stat.</em>
<a id='L2' name='L2'></a>   2 <em class='comment'>   Copyright (C) 1989, 1991-2016 Free Software Foundation, Inc.</em>
<a id='L3' name='L3'></a>   3 <em class='comment'></em>
<a id='L4' name='L4'></a>   4 <em class='comment'>   This program is free software: you can redistribute it and/or modify</em>
<a id='L5' name='L5'></a>   5 <em class='comment'>   it under the terms of the GNU General Public License as published by</em>
<a id='L6' name='L6'></a>   6 <em class='comment'>   the Free Software Foundation, either version 3 of the License, or</em>
<a id='L7' name='L7'></a>   7 <em class='comment'>   (at your option) any later version.</em>
<a id='L8' name='L8'></a>   8 <em class='comment'></em>
<a id='L9' name='L9'></a>   9 <em class='comment'>   This program is distributed in the hope that it will be useful,</em>
<a id='L10' name='L10'></a>  10 <em class='comment'>   but WITHOUT ANY WARRANTY; without even the implied warranty of</em>
<a id='L11' name='L11'></a>  11 <em class='comment'>   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</em>
<a id='L12' name='L12'></a>  12 <em class='comment'>   GNU General Public License for more details.</em>
<a id='L13' name='L13'></a>  13 <em class='comment'></em>
<a id='L14' name='L14'></a>  14 <em class='comment'>   You should have received a copy of the GNU General Public License</em>
<a id='L15' name='L15'></a>  15 <em class='comment'>   along with this program.  If not, see &lt;http://www.gnu.org/licenses/&gt;.  */</em>
<a id='L16' name='L16'></a>  16 
<a id='L17' name='L17'></a>  17 <em class='comment'>/* *INDENT-OFF* */</em>
<a id='L18' name='L18'></a>  18 <em class='comment'>/*</em>
<a id='L19' name='L19'></a>  19 <em class='comment'>   Macros defined by this file (s is an rvalue of type struct stat):</em>
<a id='L20' name='L20'></a>  20 <em class='comment'></em>
<a id='L21' name='L21'></a>  21 <em class='comment'>   DEV_BSIZE:       The device blocksize.  But use ST_NBLOCKSIZE instead.</em>
<a id='L22' name='L22'></a>  22 <em class='comment'>   ST_BLKSIZE(s):   Preferred (in the sense of best performance) I/O blocksize</em>
<a id='L23' name='L23'></a>  23 <em class='comment'>                    for the file, in bytes.</em>
<a id='L24' name='L24'></a>  24 <em class='comment'>   ST_NBLOCKS(s):   Number of blocks in the file, including indirect blocks.</em>
<a id='L25' name='L25'></a>  25 <em class='comment'>   ST_NBLOCKSIZE:   Size of blocks used when calculating ST_NBLOCKS.</em>
<a id='L26' name='L26'></a>  26 <em class='comment'> */</em>
<a id='L27' name='L27'></a>  27 <em class='comment'>/* *INDENT-ON* */</em>
<a id='L28' name='L28'></a>  28 
<a id='L29' name='L29'></a>  29 <em class='sharp'>#ifndef</em> <a href='../S/lib--stat-size.h.html#L30' title='Defined at 30 in lib/stat-size.h.'>STAT_SIZE_H</a>
<a id='L30' name='L30'></a>  30 <em class='sharp'>#define</em> <a href='../S/lib--stat-size.h.html#L29' title='Referred from 29 in lib/stat-size.h.'>STAT_SIZE_H</a>
<a id='L31' name='L31'></a>  31 
<a id='L32' name='L32'></a>  32 <em class='comment'>/* sys/param.h may define DEV_BSIZE */</em>
<a id='L33' name='L33'></a>  33 <em class='sharp'>#if</em> <a href='../Y/HAVE_SYS_PARAM_H.html' title='Multiple used in 7 places.'>HAVE_SYS_PARAM_H</a>
<a id='L34' name='L34'></a>  34 <em class='sharp'>#include</em> &lt;sys/param.h&gt;
<a id='L35' name='L35'></a>  35 <em class='sharp'>#endif</em>
<a id='L36' name='L36'></a>  36 
<a id='L37' name='L37'></a>  37 
<a id='L38' name='L38'></a>  38 <em class='comment'>/* Get or fake the disk device blocksize.</em>
<a id='L39' name='L39'></a>  39 <em class='comment'>   Usually defined by sys/param.h (if at all).  */</em>
<a id='L40' name='L40'></a>  40 <em class='sharp'>#if</em> !<strong class='reserved'>defined</strong> <a href='../D/DEV_BSIZE.html' title='Multiple defined in 3 places.'>DEV_BSIZE</a> &amp;&amp; <strong class='reserved'>defined</strong> <a href='../Y/BSIZE.html' title='Multiple used in 3 places.'>BSIZE</a>
<a id='L41' name='L41'></a>  41 <em class='sharp'>#define</em> <a href='../R/DEV_BSIZE.html' title='Multiple referred from 5 places.'>DEV_BSIZE</a> <a href='../Y/BSIZE.html' title='Multiple used in 3 places.'>BSIZE</a>
<a id='L42' name='L42'></a>  42 <em class='sharp'>#endif</em>
<a id='L43' name='L43'></a>  43 <em class='sharp'>#if</em> !<strong class='reserved'>defined</strong> <a href='../D/DEV_BSIZE.html' title='Multiple defined in 3 places.'>DEV_BSIZE</a> &amp;&amp; <strong class='reserved'>defined</strong> <a href='../Y/BBSIZE.html' title='Multiple used in 2 places.'>BBSIZE</a>        <em class='comment'>/* SGI sys/param.h */</em>
<a id='L44' name='L44'></a>  44 <em class='sharp'>#define</em> <a href='../R/DEV_BSIZE.html' title='Multiple referred from 5 places.'>DEV_BSIZE</a> <a href='../Y/BBSIZE.html' title='Multiple used in 2 places.'>BBSIZE</a>
<a id='L45' name='L45'></a>  45 <em class='sharp'>#endif</em>
<a id='L46' name='L46'></a>  46 <em class='sharp'>#ifndef</em> <a href='../D/DEV_BSIZE.html' title='Multiple defined in 3 places.'>DEV_BSIZE</a>
<a id='L47' name='L47'></a>  47 <em class='sharp'>#define</em> <a href='../R/DEV_BSIZE.html' title='Multiple referred from 5 places.'>DEV_BSIZE</a> 4096
<a id='L48' name='L48'></a>  48 <em class='sharp'>#endif</em>
<a id='L49' name='L49'></a>  49 
<a id='L50' name='L50'></a>  50 
<a id='L51' name='L51'></a>  51 
<a id='L52' name='L52'></a>  52 <em class='comment'>/* Extract or fake data from a 'struct stat'.</em>
<a id='L53' name='L53'></a>  53 <em class='comment'>   ST_BLKSIZE: Preferred I/O blocksize for the file, in bytes.</em>
<a id='L54' name='L54'></a>  54 <em class='comment'>   ST_NBLOCKS: Number of blocks in the file, including indirect blocks.</em>
<a id='L55' name='L55'></a>  55 <em class='comment'>   ST_NBLOCKSIZE: Size of blocks used when calculating ST_NBLOCKS.  */</em>
<a id='L56' name='L56'></a>  56 <em class='sharp'>#ifndef</em> <a href='../Y/HAVE_STRUCT_STAT_ST_BLOCKS.html' title='Multiple used in 19 places.'>HAVE_STRUCT_STAT_ST_BLOCKS</a>
<a id='L57' name='L57'></a>  57 <em class='sharp'>#define</em> <a href='../S/src--filemanager--ioblksize.h.html#L83' title='Referred from 83 in src/filemanager/ioblksize.h.'>ST_BLKSIZE</a>(<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>) <a href='../D/DEV_BSIZE.html' title='Multiple defined in 3 places.'>DEV_BSIZE</a>
<a id='L58' name='L58'></a>  58   <em class='comment'>/* coreutils' fileblocks.c also uses BSIZE.  */</em>
<a id='L59' name='L59'></a>  59 <em class='sharp'>#if</em> <strong class='reserved'>defined</strong> _POSIX_SOURCE || !<strong class='reserved'>defined</strong> <a href='../Y/BSIZE.html' title='Multiple used in 3 places.'>BSIZE</a>
<a id='L60' name='L60'></a>  60 <em class='sharp'>#define</em> <a href='../S/lib--stat-size.h.html#L87' title='Referred from 87 in lib/stat-size.h.'>ST_NBLOCKS</a>(<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>) \
<a id='L61' name='L61'></a>  61   ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_size.html' title='Multiple used in 101 places.'>st_size</a> / <a href='../D/ST_NBLOCKSIZE.html' title='Multiple defined in 3 places.'>ST_NBLOCKSIZE</a> + ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_size.html' title='Multiple used in 101 places.'>st_size</a> % <a href='../D/ST_NBLOCKSIZE.html' title='Multiple defined in 3 places.'>ST_NBLOCKSIZE</a> != 0))
<a id='L62' name='L62'></a>  62 <em class='sharp'>#else</em>
<a id='L63' name='L63'></a>  63    <em class='comment'>/* This definition calls st_blocks, which is in the fileblocks module. */</em>
<a id='L64' name='L64'></a>  64 <em class='sharp'>#define</em> <a href='../S/lib--stat-size.h.html#L87' title='Referred from 87 in lib/stat-size.h.'>ST_NBLOCKS</a>(<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>) \
<a id='L65' name='L65'></a>  65   (<a href='../S/lib--fs.h.html#L21' title='Defined at 21 in lib/fs.h.'>S_ISREG</a> ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_mode.html' title='Multiple used in 244 places.'>st_mode</a>) || <a href='../D/S_ISDIR.html' title='Multiple defined in 2 places.'>S_ISDIR</a> ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_mode.html' title='Multiple used in 244 places.'>st_mode</a>) ? \
<a id='L66' name='L66'></a>  66    <a href='../Y/st_blocks.html' title='Multiple used in 22 places.'>st_blocks</a> ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_size.html' title='Multiple used in 101 places.'>st_size</a>) : 0)
<a id='L67' name='L67'></a>  67 <em class='sharp'>#endif</em>
<a id='L68' name='L68'></a>  68 <em class='sharp'>#else</em>
<a id='L69' name='L69'></a>  69 <em class='comment'>/* When running 'rsh hpux11-system cat any-file', cat would</em>
<a id='L70' name='L70'></a>  70 <em class='comment'>   determine that the output stream had an st_blksize of 2147421096.</em>
<a id='L71' name='L71'></a>  71 <em class='comment'>   Conversely st_blksize can be 2 GiB (or maybe even larger) with XFS</em>
<a id='L72' name='L72'></a>  72 <em class='comment'>   on 64-bit hosts.  Somewhat arbitrarily, limit the "optimal" block</em>
<a id='L73' name='L73'></a>  73 <em class='comment'>   size to SIZE_MAX / 8 + 1.  (Dividing SIZE_MAX by only 4 wouldn't</em>
<a id='L74' name='L74'></a>  74 <em class='comment'>   suffice, since "cat" sometimes multiplies the result by 4.)  If</em>
<a id='L75' name='L75'></a>  75 <em class='comment'>   anyone knows of a system for which this limit is too small, please</em>
<a id='L76' name='L76'></a>  76 <em class='comment'>   report it as a bug in this code.  */</em>
<a id='L77' name='L77'></a>  77 <em class='sharp'>#define</em> <a href='../S/src--filemanager--ioblksize.h.html#L83' title='Referred from 83 in src/filemanager/ioblksize.h.'>ST_BLKSIZE</a>(<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>) ((0 &lt; (<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_blksize.html' title='Multiple used in 27 places.'>st_blksize</a> \
<a id='L78' name='L78'></a>  78                                &amp;&amp; (<a href='../Y/size_t.html' title='Multiple used in 726 places.'>size_t</a>) ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_blksize.html' title='Multiple used in 27 places.'>st_blksize</a>) &lt;= ((<a href='../Y/size_t.html' title='Multiple used in 726 places.'>size_t</a>)-1) / 8 + 1) \
<a id='L79' name='L79'></a>  79                               ? (<a href='../Y/size_t.html' title='Multiple used in 726 places.'>size_t</a>) ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_blksize.html' title='Multiple used in 27 places.'>st_blksize</a>) : <a href='../D/DEV_BSIZE.html' title='Multiple defined in 3 places.'>DEV_BSIZE</a>)
<a id='L80' name='L80'></a>  80 <em class='sharp'>#if</em> <strong class='reserved'>defined</strong> <a href='../Y/hpux.html' title='Multiple used in 2 places.'>hpux</a> || <strong class='reserved'>defined</strong> __hpux__ || <strong class='reserved'>defined</strong> __hpux
<a id='L81' name='L81'></a>  81   <em class='comment'>/* HP-UX counts st_blocks in 1024-byte units.</em>
<a id='L82' name='L82'></a>  82 <em class='comment'>     This loses when mixing HP-UX and BSD file systems with NFS.  */</em>
<a id='L83' name='L83'></a>  83 <em class='sharp'>#define</em> <a href='../R/ST_NBLOCKSIZE.html' title='Multiple referred from 2 places.'>ST_NBLOCKSIZE</a> 1024
<a id='L84' name='L84'></a>  84 <em class='sharp'>#endif</em>
<a id='L85' name='L85'></a>  85 <em class='sharp'>#endif</em>
<a id='L86' name='L86'></a>  86 
<a id='L87' name='L87'></a>  87 <em class='sharp'>#ifndef</em> <a href='../D/ST_NBLOCKS.html' title='Multiple defined in 3 places.'>ST_NBLOCKS</a>
<a id='L88' name='L88'></a>  88 <em class='sharp'>#define</em> <a href='../S/lib--stat-size.h.html#L87' title='Referred from 87 in lib/stat-size.h.'>ST_NBLOCKS</a>(<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>) ((<a href='../Y/statbuf.html' title='Multiple used in 18 places.'>statbuf</a>).<a href='../Y/st_blocks.html' title='Multiple used in 22 places.'>st_blocks</a>)
<a id='L89' name='L89'></a>  89 <em class='sharp'>#endif</em>
<a id='L90' name='L90'></a>  90 
<a id='L91' name='L91'></a>  91 <em class='sharp'>#ifndef</em> <a href='../D/ST_NBLOCKSIZE.html' title='Multiple defined in 3 places.'>ST_NBLOCKSIZE</a>
<a id='L92' name='L92'></a>  92 <em class='sharp'>#ifdef</em> <a href='../Y/S_BLKSIZE.html' title='Multiple used in 2 places.'>S_BLKSIZE</a>
<a id='L93' name='L93'></a>  93 <em class='sharp'>#define</em> <a href='../R/ST_NBLOCKSIZE.html' title='Multiple referred from 2 places.'>ST_NBLOCKSIZE</a> <a href='../Y/S_BLKSIZE.html' title='Multiple used in 2 places.'>S_BLKSIZE</a>
<a id='L94' name='L94'></a>  94 <em class='sharp'>#else</em>
<a id='L95' name='L95'></a>  95 <em class='sharp'>#define</em> <a href='../R/ST_NBLOCKSIZE.html' title='Multiple referred from 2 places.'>ST_NBLOCKSIZE</a> 512
<a id='L96' name='L96'></a>  96 <em class='sharp'>#endif</em>
<a id='L97' name='L97'></a>  97 <em class='sharp'>#endif</em>
<a id='L98' name='L98'></a>  98 
<a id='L99' name='L99'></a>  99 <em class='sharp'>#endif</em> <em class='comment'>/* STAT_SIZE_H */</em>
</pre>
<hr />
<a id='BOTTOM' name='BOTTOM'></a>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><img class='icon' src='../icons/n_bottom.png' alt='[bottom]' /><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+99 lib/stat-size.h'  /> */</em>
</body>
</html>
